home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 2 / Atari Mega Archive CD - Volume 2.iso / 8bit / cislib_b / paint.doc < prev    next >
Text File  |  1995-04-22  |  5KB  |  195 lines
  1.  
  2.                PAINT! 
  3.  
  4. Public domain software by Greg 
  5. Tavares.  -  The Nighthawk Group 
  6.  
  7. Distributed by Atari Computer  
  8. Association of Orange County 
  9. (A.C.A.O.C.).  BBS: 714-731-6523 
  10.  
  11. PAINT! allows you to draw colorful 
  12. pictures on your TV display, save 
  13. them for later viewing, and even 
  14. use them with your own program. 
  15.  
  16. Using your joystick as the paint 
  17. brush, you can choose a color or 
  18. pattern from anyone of the ten paint 
  19. cans.  Four colors are available, 
  20. as well as an unlimited number of 
  21. patterns using the available colors. 
  22. Special features include a fill 
  23. mode, a draw-to mode, and a 
  24. close-up mode. 
  25.  
  26. BASIC is not required to run the 
  27. PAINT! program.  Load it from DOS 
  28. using the "L" command in Atari DOS, 
  29. or LOAD command in  OSS DOS. 
  30. Alternatively, it can be automat- 
  31. ically loaded and run by renaming 
  32. it AUTORUN.SYS for Atari DOS, or 
  33. using the STARTUP.EXC feature in 
  34. OSS DOS. 
  35.  
  36. Upon running PAINT! the option 
  37. screen displays the various disk 
  38. commands. 
  39.  
  40. L - Load a picture. 
  41.  
  42. S - Save a picture. 
  43.  
  44. D - Delete a picture. 
  45.  
  46. R - Rename a picture. 
  47.  
  48. + - Lock a picture file. 
  49.  
  50. - - Unlock a picture file. 
  51.  
  52. C - (Catalog) List the files on the 
  53.     disk. 
  54.  
  55. RETURN - Go to paint screen. 
  56.  
  57. From the paint screen, the following 
  58. commands are available: 
  59.  
  60. OPTION - Return to the option screen 
  61.          with disk commands. 
  62.  
  63. <CONTROL> - Clear the screen. 
  64.  CLEAR 
  65.  
  66. SPACE - Enlarge current working 
  67. BAR     area for detailed drawing. 
  68.         Push SPACE BAR again to  
  69.         return to normal mode. 
  70.  
  71. C - Change color.  Press C and then 
  72.     1, 2, 3, or 4 to change the 
  73.     respective color.  Move the 
  74.     joystick up and down to change 
  75.     luminance (brightness), left 
  76.     and right to change hue (color). 
  77.     Press the fire button when 
  78.     finished. 
  79.  
  80. D - Draw mode.  The cursor will 
  81.     resemble an "X".  Draw by pushing 
  82.     the fire button while moving the 
  83.     the joystick. 
  84.  
  85. E - Elastic (draw-to) mode.  The 
  86.     Cursor will resemble an "O". 
  87.     Push the fire button once to 
  88.     define the starting point. 
  89.     Move the cursor to place the 
  90.     line as desired and push the 
  91.     fire button again. 
  92.  
  93. F - Fill mode.  The cursor will 
  94.     resemble a "+".   Move the 
  95.     cursor within the boundries 
  96.     to be filled and press the fire 
  97.     button. 
  98.  
  99. H - Halt fill mode.  Use to halt 
  100.     filling of an area, or if fill 
  101.     mode hangs up. 
  102.  
  103. p - Change pattern.  The cursor will 
  104.     resemble a "[]".  Select from 
  105.     paint cans 5 through 10. Position 
  106.     the cursor over the area with 
  107.     the desired pattern and push the 
  108.     fire button.  The pattern will 
  109.     be transferred to the selected 
  110.     paint can.  All four colors 
  111.     should not be in the selected 
  112.     pattern. 
  113.  
  114. U - Undo.  Removes the last command 
  115.     from the picture. 
  116.  
  117. W - Paint can window select.  Turns 
  118.     display of paint cans off and on. 
  119.  
  120. 0-9 - Choose paint color to use. 
  121.     The color chosen is shown by a 
  122.     line covering the can.  You can 
  123.     also chose a color by moving the 
  124.     cursor to the paint can and 
  125.     pressing the fire button. 
  126.  
  127. To move the paint can window: 
  128.     1. Move cursor to the arrow box 
  129.     in the window.  Push the fire 
  130.     button and move up or down with 
  131.     the joystick, or; 
  132.     2. Hold the button on a paddle 
  133.     controller plugged into Port 2 
  134.     and turn the paddle. 
  135.  
  136. The picture save format is as 
  137. follows.  This format is the same 
  138. as Micro-Painter. 
  139.  
  140. Screen Memory = 7680 bytes. 
  141. Color bytes: 
  142. Color 1 - memory location 712. 
  143. Color 2 - Memory location 708. 
  144. Color 3 - Memory location 709. 
  145. Color 4 - Memory location 710. 
  146.  
  147. Use the following guidelines for 
  148. loading pictures from BASIC.  The 
  149. same principles apply when using 
  150. other programming languages. 
  151.  
  152. * Graphics 8 no window.  (Change 
  153.   24 to a 8 if you want the window.) 
  154. 10 GR.24 
  155. * Find Display list 
  156. 20 S=PEEK(560)+256*PEEK(561) 
  157. * Change Graphics mode to the same 
  158.   one paint uses. 
  159. 30 FOR I=1 TO 210 
  160. 40 IF PEEK(S+I)=15 THEN POKE S+I,14 
  161. 50 IF PEEK(S+I)=79 THEN POKE S+I,78 
  162. 60 NEXT I 
  163. * Open the picture file for reading 
  164. 70 OPEN #1,4,0,"D:NAME.PIC" 
  165. * Tell the operating system you want 
  166.   to read. 
  167. 80 IOCB=848:POKE IOCB+2,7 
  168. * Tell it you want it to store the 
  169.   information in the screen  memory. 
  170. 90 POKE  IOCB+4,PEEK(88):POKE IOCB+5, 
  171.    PEEK(89) 
  172. * And you want it to store 7680 
  173.   bytes there (0 + 256 * 30 = 7680) 
  174. 100 POKE IOCB+8,0:POKE IOCB+9,30 
  175. * Make it do it. 
  176. 110 USER=USR(ADR("hhh*LVd"),16) 
  177.   The characters between the quotes 
  178.   are small h, small h, small h, 
  179.   inverse asterisk, capital L, 
  180.   capital V, inverse small d 
  181. * Read colors and store them in 
  182.   their proper places. 
  183. 120 GET #1,X:POKE 712,X 
  184. 130 GET #1,X:POKE 708,X 
  185.  
  186. 140 GET #1,X:POKE 709,X 
  187. 150 GET #1,X:POKE 710,X 
  188.  
  189. 160 CLOSE #1 
  190. 200 GOTO 200 
  191.  
  192. Let your creativity flow and draw up 
  193. some breathtaking pictures! 
  194.  
  195.